home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 2 / CU Amiga Magazine's Super CD-ROM 02 (1996)(EMAP Images)(GB)[!][issue 1996-04].iso / misc / blitz_basic_2_demo / readme_or_suffer < prev    next >
Text File  |  1996-02-18  |  6KB  |  197 lines
  1.                   Blitz Basic 2.1 (CU-Amiga CD Demo)
  2.                   ==================================
  3.  
  4.  
  5.  
  6. About this demo
  7. ---------------
  8.  
  9. 1) You cannot create stand alone executables with this demo version.
  10.  
  11. 2) This demo contains some of the new features of Blitz Basic 2.1
  12.  
  13.    New editor    - Version 2.1a  (OS2.1 menu problem fixed I hope)
  14.    New debugger  - Version 2.1
  15.    Large Deflibs - Contains lots of new third party commands
  16.  
  17.    The new editor/debugger only work with OS2.1 or better and because they
  18.    are quite large, you really need 2Mb of memory to compile large programs.
  19.  
  20. 3) All the example source code (examples and games dirs) should have 
  21.    runtime error checking on by default. Once you know a program runs
  22.    successfully, recompile it with runtime errs off (compiler menu/
  23.    compiler options).
  24.  
  25. 4) To make sure Blitz has the right path to a programs data files, start
  26.    up Blitz by clicking on a source code icon instead of the Blitz2 icon.
  27.  
  28. 5) Don't forget to use 'Right Amiga-Help' on the same line as a Blitz
  29.    command to bring up the on-line help, or 'Help' on its own to display
  30.    the command syntax in the screen title.
  31.  
  32. 6) For more information contact:
  33.  
  34.        Acid Software
  35.        c/o Guildhall Leisure Services
  36.        Unit 15, Guildhall Industrial Estate
  37.        Kirk Sandall
  38.        Doncaster
  39.        DN3 1QR
  40.  
  41.        Phone: 01302 890000
  42.        Fax: 01302 890010
  43.  
  44.        Email: Ted@blitzuk.demon.co.uk
  45.   
  46.  
  47.  
  48. Demo Contents
  49. -------------
  50.  
  51. Blitzlibs   -  A directory containg a few resident files, which some of
  52.                the examples may require.
  53.  
  54. Bums        -  Examples from the Blitz User Magazines 5-8. When you buy
  55.                Blitz Basic 2.1 you receive a registration card and the
  56.                chance to subscribe to BUM. The next issue is BUM 9 and 
  57.                it should be available soon. It costs 5UKP for an issue
  58.                which usually consists of two disks that unpack onto four
  59.                disks. BUMs contain the latest fixes, libs, etc and lots
  60.                of examples.
  61.  
  62. Docs        -  Documentation for the Acid Blitz commands, the third party
  63.                library commands, the new editor and the new debugger.
  64.  
  65. Examples    -  Plenty of examples covering most of the Blitz commands. Just
  66.                double-click on one of the source code icons and away you
  67.                go. All the examples should have runtime error checking on
  68.                by default, so once a program runs correctly, recompile it
  69.                with runtime errs off (compiler menu/compiler options).
  70.  
  71. Games       -  Lots of executable games, most of them with source code.
  72.  
  73.  
  74.  
  75.  
  76. Installing to Hard Disk 
  77. -----------------------
  78.  
  79. 1) Make a new directory on your Hard Drive.
  80.  
  81. 2) Copy    the following files from the Blitz directory on the CD into
  82.    your new directory.    
  83.  
  84.          Blitzlibs <dir>
  85.  
  86.          Acidlibs
  87.          Blitz2
  88.          Blitz2.info
  89.          Deflibs
  90.          Defaultdbug    
  91.          Help
  92.          Help.dat
  93.          Ted
  94.          Ted.info
  95.  
  96. 3) Copy ted.library from CUCD:Libs into your Workbench Libs directory.
  97.  
  98. 4) Add the following to your startup-sequence or type it into a shell
  99.    before running Blitz.
  100.  
  101.          Assign BLITZ2: <your hd>:<your new directory>     
  102.      Assign BLITZLIBS: <your hd>:<your new directory>/blitzlibs
  103.  
  104.  
  105.  
  106. Thanks
  107. ------
  108.  
  109. Fingers for being so courteous and patient.
  110.  
  111. RWE/LES/RI for their very nice libs/docs.
  112.  
  113. Xbones for his protracker lib.
  114.  
  115. Tiffs, ><>, and all the others on the Blitz List.
  116.  
  117. Me for creating yet another Blitz demo.
  118.  
  119.  
  120.  
  121.  
  122.  
  123.                    Blitz Basic 2.1 Release Notes
  124.                    =============================
  125.  
  126.  
  127. 1. Introduction
  128. ---------------
  129.  
  130. Welcome to Mark Sibly's BlitzBasic programming language. A powerful
  131. integrated programming environment for all Amiga computers.
  132.  
  133. New to version 2.1:
  134.  
  135. - online help
  136. - restructured library handling
  137. - bug free parameter passing
  138. - comprehensive AGA and 3.0 support
  139.  
  140. The main Blitz program disk has been put together so users programming
  141. on 1 meg single floppy A500 systems can boot straight from the disk
  142. and start programming immediately. Those with more powerful systems
  143. should note that due to space restrictions the advanced debugger,
  144. third party libraries and enhanced editor can be found on the extras
  145. disk.
  146.  
  147.  
  148.  
  149. 2. Up and Running
  150. -----------------
  151.  
  152. A lot of reviews of Blitz have criticised it for being unstable. Most
  153. often they have missed the fundamental concept of runtime errors that
  154. Blitz uses to stop your program crashing during development.
  155.  
  156. When runtime errors are enabled from the compiler options, Blitz compiles
  157. your program with checks on every command so it can't do the guru thing
  158. and make us at Acid look bad. These checks however make your program bigger
  159. and slower making us at Acid look bad anyway.
  160.  
  161. As we don't really care what we look like, we offer this advise; always
  162. enable runtime errors until you are quite sure your program can not
  163. fall over (bringing up the runtime error debugger). Once you are sure
  164. it is bulletproof THEN disable error checking and let it fly. This also
  165. applies to official Acid demos as wrong directories and unfound files
  166. may cause errors also.
  167.  
  168.  
  169. 3. Online Help
  170. --------------
  171.  
  172. Previous versions of Blitz incorporated a simple syntax help system
  173. whereby pressing the Help key when the cursor was on a Blitz command
  174. would print the syntax of that command on the title bar.
  175.  
  176. Blitz2.1 now sports a full online reference manual, simply use the Right
  177. Amiga/Help keyboard combination to invoke the Blitz online help software.
  178.  
  179.  
  180. 4. Library handling
  181. -------------------
  182.  
  183. BlitzBASIC commands are loaded by the program from several sources:
  184.  
  185. acidlibs - a single file containing standard Blitz commands
  186. deflibs  - commands compiled from third party libs found in blitzlibs:
  187. userlibs - all libs found in directories branching off blitz2:userlibs
  188.  
  189. The reason for this change is to make it easier for Acid Software to
  190. distribute libs in the future. Users who build up a collection of third
  191. party libraries in their deflibs file will be able to upgrade their
  192. acidlibs without reconstructing their entire blitzlibs: volume.
  193.  
  194. Those developers creating their own libraries can now use the userlibs
  195. drawer to hold beta versions of their compiled libs allowing for much
  196. faster reloading of libs during development.
  197.